home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 11 / Cream of the Crop 11-2.iso / os2 / gnucal.zip / gcal-de.info-3 (.txt) < prev    next >
GNU Info File  |  1995-12-20  |  52KB  |  1,019 lines
  1. This is Info file ./gcal-de.info, produced by Makeinfo-1.63 from the
  2. input file ./doc/tex/gcal-de.texi.
  3. Diese Datei beschreibt Gcal, ein Programm um Kalender auszugeben.  Gcal
  4. gibt Monatskalender und Jahreskalender, ewige Feiertagslisten sowie
  5. Terminwarnungslisten auf viele verschiedene Arten und Weisen aus.  Es
  6. ber"ucksichtigt diejenigen Daten korrekt, welche "ubergangen wurden,
  7. als der derzeitig g"ultige Gregorianische Kalender den vormals g"ultigen
  8. Julianischen Kalender abl"oste.
  9. Copyright (C) 1994, 1995 Thomas Esken
  10. Das ist die erste Auflage der Gcal Dokumentation.
  11. Hiermit wird die Erlaubnis erteilt, wortgetreue Kopien dieses Handbuches
  12. zu erstellen und zu vertreiben, sofern alle gemachten Kopien mit dem
  13. Copyrightvermerk und diesem Genehmigungsvermerk ausgestattet sind und
  14. vorgenannte Vermerke erhalten bleiben.
  15. Hiermit wird die Erlaubnis erteilt, ver"anderte Kopien dieses Handbuches
  16. wie unter den Bedingungen f"ur wortgetreue Kopien zu erstellen und zu
  17. vertreiben, sofern die ausgef"uhrten Arbeiten in Ableitung und
  18. Gesamtheit innerhalb der Bestimmungen eines Genehmigungvermerks liegen
  19. und zudem mit diesem ausgestattet sind, welcher mit diesem hier
  20. identisch ist.
  21. Hiermit wird die Erlaubnis erteilt, wie unter den vorgenannten
  22. Bedingungen f"ur ver"anderte Versionen "Ubersetzungen dieses Handbuches
  23. in eine andere Sprache zu erstellen und zu vertreiben, mit der
  24. Ausnahme, da"s dieser Genehmigungsvermerk in einer "Ubersetzung
  25. angegeben sein darf, welche von der Stiftung gebilligt wird.
  26. Jedwede Vorschl"age, Verbesserungen, Erweiterungen, Fehlerberichte,
  27. Geld- und Sachspenden, Programmierauftr"age usw. sind stets willkommen.
  28. Bitte senden Sie diese direkt an meine Email Adresse.  Wenn Sie dieses
  29. Werkzeug m"ogen, so w"urde ich mich sehr "uber eine Postkarte von Ihnen
  30. freuen!
  31.                                 \\\_''/'
  32. -------------------------oOO    (/o-o\)    OOo-------------------------
  33. Thomas Esken                o  (.  "  .)  o   Internet :
  34. Im Hagenfeld 84              \___) ~ (___/      <esken@uni-muenster.de>
  35. D-48147 Muenster; GERMANY                     Phone : (+49) 0251 232585
  36. File: gcal-de.info,  Node: Ewige Feiertage,  Next: Terminwarnungen,  Prev: Aufruf von Gcal,  Up: Top
  37. Ewige Feiertage
  38. ***************
  39. Die *ewige Feiertagsliste* wird nur f"ur Jahre nach A.D.463 erzeugt.
  40. Sie kann auf mehrere Arten und Weisen ausgegeben werden:
  41. Wenn Gcal ohne explizites (Fiskal) Datum mit dem *ewige Feiertagsliste*
  42. Argument gestartet wird (*note `--holiday-list[=long|short]': Kalender
  43. Optionen.), z.B.:
  44.      gcal --holiday-list
  45.      gcal -n
  46.      gcal -n :
  47. so gibt Gcal ohne einen vorangehenden Kalender alle diejenigen
  48. Feiertage aus der ewigen Feiertagsliste aus, die sich auf das aktuelle
  49. Jahr bzw. Fiskaljahr beziehen.
  50. Wenn Gcal mit dem *ewige Feiertagsliste* Argument und einem Monat (plus
  51. eines Jahres) gestartet wird, z.B.:
  52.      gcal --holiday-list juli
  53.      gcal -n juli
  54.      gcal -n 7 1993
  55.      gcal -n 7/1993
  56. so gibt Gcal einen Monatskalender des angegebenen Monats (des Jahres)
  57. und nachfolgend alle diejenigen Feiertage aus der ewigen Feiertagsliste
  58. aus, die sich auf den angegebenen Monat (des angegebenen Jahres)
  59. beziehen.
  60. Wenn Gcal mit dem *ewige Feiertagsliste* Argument und einem einfachen
  61. Jahr oder einem Fiskaljahr (abweichendes Wirtschaftsjahr) gestartet
  62. wird, z.B.:
  63.      gcal --holiday-list 1993
  64.      gcal -n 1993
  65.      gcal -n juli:
  66.      gcal -n :1993
  67.      gcal -n 7:1993
  68. so gibt Gcal einen Jahreskalender des angegebenen Jahres und nachfolgend
  69. alle diejenigen Feiertage aus der ewigen Feiertagsliste aus, die sich
  70. auf das angegebene Jahr bzw. Fiskaljahr beziehen.
  71. Wenn Gcal mit dem *ewige Feiertagsliste* Argument und einem der
  72. speziellen 3-Monatsmodus Kommandos gestartet wird (*note `..':
  73. Kommandos.), z.B.:
  74.      gcal --holiday-list .
  75.      gcal -n .
  76.      gcal -n ..
  77.      gcal -n .+
  78.      gcal -n .-
  79. so gibt Gcal die bezogenen 3 Monate im festen Layout/Stil eines
  80. Jahreskalenders aus, sowie nachfolgend alle diejenigen Feiertage aus
  81. der ewigen Feiertagsliste aus, die sich auf diese Monate beziehen.
  82. File: gcal-de.info,  Node: Terminwarnungen,  Next: Heutiger Kalender,  Prev: Ewige Feiertage,  Up: Top
  83. Terminwarnungen
  84. ***************
  85. Dieses Kapitel beschreibt wie Gcal f"ur *Terminwarnungszwecke* benutzt
  86. werden kann.  Dazu darf eine Gcal spezifische Resourcendatei erzeugt
  87. werden, welche Eintr"age zur Terminwarnung enth"alt (*note
  88. Resourcendatei::.).
  89. Jedesmal wenn Gcal im einfachen Einzelmonatsmodus ausgef"uhrt wird,
  90. d.h. beim Aufruf von Gcal wurde in der Kommandozeile weder ein
  91. expliziter Monat noch ein explizites Jahr bzw. Fiskaljahr angegeben,
  92. aber das *Terminwarnungs* Argument vorgefunden wird, z.B.:
  93.      gcal --list-of-fixed-dates
  94.      gcal -c
  95. so durchsucht Gcal die Resourcendatei nach Daten und verarbeitet genau
  96. solche, die sich auf das aktuelle (==heutige) Datum beziehen.  Sodann
  97. gibt Gcal ohne einen vorangehenden Kalender alle diejenigen
  98. Terminwarnungen aus der Resourcendatei aus, die sich auf den aktuellen
  99. Tag (Woche/Monat/Jahr) des aktuellen Jahres beziehen.
  100. Einige weitere Beispiele hierzu:
  101.      gcal -ce
  102.      gcal -cw-
  103.      gcal -c-m
  104.      gcal -c-y-
  105.      gcal -jcb -c-et
  106.      gcal -cey-
  107.      gcal -jc -cey
  108. Die Liste der Terminwarnungen kann auf mehrere Arten und Weisen
  109. ausgegeben werden:
  110. Wenn Gcal mit dem *Terminwarnungs* Argument und/oder einem Monat
  111. und/oder einem expliziten Jahr bzw. Fiskaljahr gestartet wird; bzw. mit
  112. einem der speziellen 3-Monatsmodus Kommandos, z.B.:
  113.      gcal -c juli
  114.      gcal -ce 7 1994
  115.      gcal -c-y 7/1994
  116.      gcal -c 7:1993
  117.      gcal -c 1993
  118.      gcal -c .
  119.      gcal -c .+
  120. so gibt Gcal einen (drei) Monats-/ Jahreskalender des angegebenen bzw.
  121. aktuellen Monats-/ Jahres aus und nachfolgend alle diejenigen
  122. Terminwarnungen aus der Resourcendatei, die sich auf den angegebenen
  123. Zeitraum beziehen; das Warnungsniveau ist wie bei der `-cy' Option,
  124. wenn sich der Warnungszeitraum auf ein Jahr bzw. Fiskaljahr bezieht
  125. oder auf eine 3-Monatsperiode, bzw.  wie bei der `-cm' Option, wenn
  126. sich der Warnungszeitraum auf einen Monat bezieht.
  127. Wenn Gcal ohne explizites Datum mit dem *Terminwarnungs* Argument *in
  128. Verbindung mit* dem *ewige Feiertagsliste* Argument gestartet wird,
  129. z.B.:
  130.      gcal -c -n
  131.      gcal -Cm -n
  132.      gcal -Cl1224 -n
  133.      gcal -cl3+ -n
  134. so gibt Gcal ohne einen vorangehenden Kalender alle diejenigen
  135. Terminwarnungen aus der Resourcendatei aus, die sich auf den
  136. angegebenen Warnungszeitraum im aktuellen Jahr beziehen, und
  137. nachfolgend alle diejenigen Feiertage aus der ewigen Feiertagsliste
  138. aus, die sich auf das gesamte aktuelle Jahr beziehen.  F"ur weitere
  139. Details zur *ewigen Feiertagsliste*, siehe *Note Ewige Feiertage::.
  140. *Anmerkung zu vorhergehenden Beispielen:*
  141. Falls das *Standard/Spezielle Kalenderformat* Argument (*note
  142. `--type=special|standard': Kalender Optionen.) oder das *Starttag der
  143. Woche* Argument (*note `--starting-day[=ARG]': Kalender Optionen.)
  144. (ausgenommen der `-s 0' Option bzw. `--starting-day=0' Option) zudem
  145. mit vorgefunden wird, z.B.:
  146.      gcal -c -n -i
  147.      gcal -c -i-
  148.      gcal -n -i- :
  149.      gcal -n -s Sonntag
  150. so gibt Gcal einen Monats-/ Jahreskalender vor jeder anderen
  151. angeforderten Liste aus!
  152. Jedesmal wenn Gcal im einfachen Einzeljahresmodus ausgef"uhrt wird,
  153. d.h. beim Aufruf von Gcal wurde in der Kommandozeile weder ein
  154. expliziter Monat noch ein explizites Jahr bzw. Fiskaljahr angegeben,
  155. aber das *Terminwarnungs* Argument (evtl. mit Modifizierern) und das
  156. *Anzahl der Monatsbl"ocke* Argument vorgefunden wird (*note
  157. `--blocks=ARG': Kalender Optionen.), z.B.:
  158.      gcal -c --blocks=3
  159.      gcal -C-em -b 3
  160.      gcal -c-t -b 6 -jc
  161. so durchsucht Gcal die Resourcendatei nach Daten und verarbeitet genau
  162. jene, die sich auf das aktuelle (==heutige) Datum beziehen.  Sodann
  163. gibt Gcal einen vorangehenden Jahreskalender und alle diejenigen
  164. Terminwarnungen aus der Resourcendatei aus, die sich auf den aktuellen
  165. Tag (Woche/Monat/Jahr) des aktuellen Jahres beziehen.
  166. Es k"onnen aber auch Daten von vergangenen, aktuellen oder zuk"unftigen
  167. Monaten/Jahren verarbeitet werden.  Das geht einerseits, indem die
  168. `%DATUM' Option entsprechend verwendet wird (*note
  169. Datummodifizierer::.), oder andererseits, indem ein Kommando bzw.  eine
  170. *Liste* oder ein *Bereich* von Kommandos verwendet wird.
  171. Zum Beispiel:
  172. `gcal -c 1993'
  173.      Ausgabe aller Datumeintr"age in aufsteigender Reihenfolge, welche
  174.      sich auf das gesamte Jahr 1993 beziehen und aller ewigen
  175.      Datumeintr"age, welche sich auf das gesamte Jahr 1993 beziehen;
  176.      das Warnungsniveau ist wie bei der `-cy' Option.
  177. `gcal -c- juli:1993'
  178.      Ausgabe aller Datumeintr"age in absteigender Reihenfolge, welche
  179.      sich auf das Fiskaljahr - beginnend im Monat Juli 1993 und endend
  180.      im Monat Juni 1994 - beziehen, und aller ewigen Datumeintr"age,
  181.      welche sich auf das Fiskaljahr - beginnend im Monat Juli 1993 und
  182.      endend im Monat Juni 1994 - beziehen; das Warnungsniveau ist wie
  183.      bei der `-cy' Option.
  184. `gcal -ce juli 1993'
  185.      Ausgabe aller Datumeintr"age in aufsteigender Reihenfolge, welche
  186.      sich auf den Monat Juli 1993 beziehen und aller ewigen
  187.      Datumeintr"age, welche sich auf den Monat Juli 1993 beziehen, und
  188.      aller ewigen Feiertage, welche sich auf den Monat Juli 1993
  189.      beziehen; das Warnungsniveau ist wie bei der `-cm' Option.
  190. `gcal -c-e 1993'
  191.      Ausgabe aller Datumeintr"age in absteigender Reihenfolge, welche
  192.      sich auf das gesamte Jahr 1993 beziehen und aller ewigen
  193.      Datumeintr"age, welche sich auf den Monat Juli 1993 beziehen, und
  194.      aller ewigen Feiertage, welche sich auf den Monat Juli 1993
  195.      beziehen; das Warnungsniveau ist wie bei der `-cy' Option.
  196. * Menu:
  197. * Resourcendatei::           Wie eine Resourcendatei benutzt wird.
  198. * Resourcendateibeispiele::  Beispiele zu Eintr"agen in der Resourcendatei.
  199. File: gcal-de.info,  Node: Resourcendatei,  Next: Resourcendateibeispiele,  Prev: Terminwarnungen,  Up: Terminwarnungen
  200. Resourcendatei
  201. ==============
  202. Dieser Textteil beschreibt wie eine "Resourcendatei", welche Eintr"age
  203. zur Terminwarnung enth"alt, benutzt wird.  Der Name der
  204. Standard-Resourcendatei ist `./.gcalrc' (1).
  205. Gcal benutzt einen speziellen Datei-Suchmechanismus:
  206.   1. Das Gcal Programm erwartet die Standard-Resourcendatei im aktuellen
  207.      Dateiverzeichnis und schaut zuerst dort nach.
  208.   2. Sollte vorherige Aktion versagt haben, so inspiziert Gcal das
  209.      Dateiverzeichnis, welches in der Umgebungsvariablen `HOME'
  210.      angegeben ist.  Falls die Umgebungsvariable `HOME' weder definiert
  211.      noch gesetzt ist, so "ubergeht Gcal diesen Schritt.  *Note HOME:
  212.      Umgebungsvariablen.
  213.   3. Sollte vorherige Aktion versagt haben, so durchsucht Gcal
  214.      diejenigen Dateiverzeichnisse nach der Standard-Resourcendatei,
  215.      welche in der Umgebungsvariablen `GCALPATH' (2) (*note GCALPATH:
  216.      Umgebungsvariablen.), angegeben sind.  Die Umgebungsvariable
  217.      `GCALPATH' enth"alt eine durch `:' Doppelpunkt getrennte Liste von
  218.      Dateiverzeichnissen.  Falls eine solche Umgebungsvariable weder
  219.      definiert noch gesetzt ist, so "ubergeht Gcal diesen Schritt.
  220.   4. Sollte vorherige Aktion versagt haben, so inspiziert Gcal das
  221.      *Benutzer-Bibliotheksverzeichnis* (normalerweise
  222.      `$HOME/lib/gcal-lib') nach der Standard-Resourcendatei.  Dieses
  223.      Verzeichnis ist ein Dateiverzeichnis relativ zum `HOME'
  224.      Dateiverzeichnis.  Falls eine `GCAL_USR_LIBDIR' Umgebungsvariable
  225.      gesetzt ist, so wird Gcal den Inhalt dieser Umgebungsvariablen an
  226.      den Inhalt der `HOME' Umgebungsvariablen anf"ugen, und zuerst
  227.      diesen Dateiverzeichnisnamen anstelle des beim
  228.      Kompilationsvorgangs eingebrannten Dateiverzeichnisnamens benutzen
  229.      (*note GCAL_USR_LIBDIR: Umgebungsvariablen.).  Falls die
  230.      Umgebungsvariable `HOME' weder definiert noch gesetzt ist, so
  231.      "ubergeht Gcal diesen Schritt.
  232.   5. Sollten alle bisherigen Aktionen versagt haben, so inspiziert Gcal
  233.      das *System-Bibliotheksverzeichnis* (normalerweise
  234.      `/usr/lib/gcal-lib' oder `$(prefix)/lib/gcal-lib') nach der
  235.      Standard-Resourcendatei.  Dieses Verzeichnis ist ein
  236.      Dateiverzeichnis absolut zum *Wurzel*/*$(prefix)*
  237.      Dateiverzeichnis.  Falls eine `GCAL_SYS_LIBDIR' Umgebungsvariable
  238.      gesetzt ist, so wird Gcal zuerst diesen Dateiverzeichnisnamen
  239.      anstelle des beim Kompilationsvorgang eingebrannten
  240.      Dateiverzeichnisnamens benutzen (*note GCAL_SYS_LIBDIR:
  241.      Umgebungsvariablen.).
  242. Falls die Standard-Resourcendatei nicht w"ahrend der Schritte 1...5 des
  243. Datei-Suchmechanismus' aufgefunden wurde, so werden keinerlei
  244. Terminwarnungen erzeugt!
  245. Wenn ein `-f|F NAME[+...]' bzw.  `--resource-file=ARG'
  246. Kommandozeilenargument vorgefunden wird, so wird eine Datei NAME
  247. anstelle der Standard-Resourcendatei als Resourcendatei benutzt.  *Note
  248. `--resource-file=ARG': Terminwarnungs Optionen.
  249. Ein "Pfadname" enth"alt ein oder mehrere `/' Zeichen und bezeichnet
  250. eine Datei, deren Zugriffspfad entweder vom Wurzeldateiverzeichnis
  251. (root-directory) aus fest vorgegeben ist, wie z.B. `/foo/bar/file',
  252. oder vom aktuellen Dateiverzeichnis aus fest vorgegeben ist, wie z.B.
  253. `./bar/file' oder `../bar/file'.  Falls NAME ein Pfadname ist:
  254.      Wenn NAME vorgefunden wird, so wird Gcal diese Datei auswerten.
  255.      Wenn NAME nicht vorgefunden wird, so wird Gcal diese Datei nicht
  256.      auswerten.
  257. Ein "einfacher" Dateiname enth"alt kein `/' Zeichen und somit auch
  258. keinen fest vorgegebenen Zugriffspfad, wie z.B. `file'.  Falls NAME ein
  259. einfacher Dateiname ist:
  260.      Gcal wird versuchen, die Datei NAME unter Zuhilfenahme des zuvor
  261.      erkl"arten Datei-Suchmechanismus' aufzufinden.
  262. * Menu:
  263. * Struktur einer Resourcendatei::  Wie wird eine Resourcendatei erstellt?
  264. * Datumteil einer Zeile::          Wie mu"s der Datumteil aussehen?
  265. * Textteil einer Zeile::           Wie mu"s der Textteil aussehen?
  266. * Zeile kommentieren::             Wie eine Zeile kommentiert werden kann.
  267. * Include Anweisungen::            Was sind Include Anweisungen?
  268. * Spezielle Textmakros::           Was sind Spezielle Textmakros?
  269. * Datumvariablen::                 Wie Datumvariablen benutzt werden k"onnen.
  270.   ---------- Footnotes ----------
  271.   (1)  Unter OS/2, MS-DOS und einigen anderen Systemen is der Name der
  272. Standard-Resourcendatei `./gcalrc'.
  273.   (2)  Unter `MSDOS' wird dazu die Umgebungsvariable `PATH' benutzt,
  274. und unter `OS/2' wird dazu die Umgebungsvariable `DPATH' benutzt.
  275. File: gcal-de.info,  Node: Struktur einer Resourcendatei,  Next: Datumteil einer Zeile,  Prev: Resourcendatei,  Up: Resourcendatei
  276. Struktur einer Resourcendatei
  277. -----------------------------
  278. Eine Gcal Resourcendatei ist zun"achst einmal eine reine ASCII Textdatei
  279. und kann mit jedem beliebigen Texteditor erzeugt werden, oder durch
  280. Umlenkung des *Standardausgabe Ger"atekanals* in eine Datei erzeugt
  281. werden, z.B.:
  282.      % echo '19930217 Text' >> Resourcendatei
  283. Jede Resourcendatei mu"s eine besondere, aber einfache Zeilenstruktur
  284. aufweisen, so da"s Gcal auch in der Lage ist, deren Inhalt zu
  285. interpretieren.  Jeder Termineintrag in einer Resourcendatei mu"s in
  286. zwei Teile aufgespalten werden, n"amlich einerseits in einen
  287. *Datumteil* und andererseits in einen *Textteil*, welche durch
  288. mindestens *ein* "whitespace" Trennzeichen (Tab, Space, Form-Feed ...)
  289. voneinander abgetrennt werden m"ussen (mit Ausnahme von *lokalen*
  290. Datumvariablenzuweisungen-/ operationen), z.B.:
  291.      Datumteil *whitespace* Textteil
  292. oder konkreter, z.B.:
  293.      JJJJ[MM[TT|WWW[N]]]*whitespace*TEXT
  294. oder noch konkreter, z.B.:
  295.      11940217 Ich bin der Text!
  296. File: gcal-de.info,  Node: Datumteil einer Zeile,  Next: Textteil einer Zeile,  Prev: Struktur einer Resourcendatei,  Up: Resourcendatei
  297. Datumteil einer Zeile
  298. ---------------------
  299. Die Struktur eines "Datumteils" - welcher Gcal die Information gibt
  300. wann ein Termin stattfindet - einer Zeile der Gcal Resourcendatei ist
  301. *Entweder*: `JJJJ[MM[TT|WWW[N]]]'
  302.     `JJJJ'
  303.           (4 Ziffern), ist das Jahr einschlie"slich des Jahrhunderts
  304.           (Bereich 0000...9999).  Es sind f"uhrende Nullen anzugeben
  305.           falls das Jahr kleiner 1000 ist und weitere Komponenten des
  306.           Datumteils dem Jahr folgen.
  307.     `MM'
  308.           (2 Ziffern oder 3 Zeichen), ist der Monat (Bereich 00...12
  309.           oder 99, bzw.  Jan, Feb...).  99 kodiert stets den letzten
  310.           Monat eines Jahres (== Dezember). Es sind f"uhrende Nullen
  311.           anzugeben falls der Monat kleiner 10 ist und weitere
  312.           Komponenten des Datumteils dem Monat folgen.
  313.     `TT'
  314.           (2 Ziffern), ist der Tag (Bereich 00...31 oder 99).  99
  315.           kodiert stets den letzten Tag eines Monats.  Es sind
  316.           f"uhrende Nullen anzugeben falls der Tag kleiner 10 ist und
  317.           weitere Komponenten des Datumteils dem Tag folgen.
  318.     `WWW'
  319.           (2...3 Zeichen), ist ein Wochentagsname im Kurzformat (Bereich
  320.           Mon...Son).
  321.     `N'
  322.           (1 Ziffer), ist der N'te Wochentag WWW im Monat (Bereich
  323.           1...5 oder 9).
  324.              * N == 1...5
  325.                N'ter WWW Wochentag im Monat.
  326.              * N == 9
  327.                Letzter WWW Wochentag im Monat.
  328. *Oder*: `JJJJ*d|wN[WWW]'
  329.     `JJJJ'
  330.           (4 Ziffern), ist das Jahr einschlie"slich des Jahrhunderts
  331.           (Bereich 0000...9999).  Es sind f"uhrende Nullen anzugeben
  332.           falls das Jahr kleiner 1000 ist und weitere Komponenten des
  333.           Datumteils dem Jahr folgen.
  334.     `*d'
  335.           (2 Zeichen), ist ein Bezug auf ein gew"ohnliches Tagesdatum.
  336.     `*w'
  337.           (2 Zeichen), ist ein Bezug auf ein ISO-8601:1988 Wochendatum.
  338.     `N'
  339.           (1...3 Ziffern), ist der Wert in Tagen oder Wochen, an
  340.           welchem der Termin auftritt.  Falls das berechnete Datum
  341.           nicht im Jahr auftritt, also au"serhalb der Jahresgrenzen
  342.           liegt, so wird die Terminwarnung unterdr"uckt.
  343.     `WWW'
  344.           (2...3 Zeichen), ist ein Wochentagsname im Kurzformat (Bereich
  345.           Mon...Son).
  346. *Oder*: `JJJJ@e|DVAR[[+|-]N]'
  347.     `JJJJ'
  348.           (4 Ziffern), ist das Jahr einschlie"slich des Jahrhunderts
  349.           (Bereich 0000...9999).  Es sind f"uhrende Nullen anzugeben
  350.           falls das Jahr kleiner 1000 ist und weitere Komponenten des
  351.           Datumteils dem Jahr folgen.
  352.     `@e'
  353.           (2 Zeichen), ist ein Bezug auf das Datum des Ostersonntags.
  354.     `@DVAR'
  355.           (2 Zeichen), ist ein Bezug auf ein Datumvariable.
  356.     `[+|-]N'
  357.           (1...4 alphanumerische Zeichen), ist der optionale Versatz in
  358.           Tagen, an welchem der Termin relativ zum Datum des
  359.           Ostersonntags oder zum Datum der Datumvariablen auftritt.
  360.           Falls das berechnete Datum nicht im Jahr auftritt, also
  361.           au"serhalb der Jahresgrenzen liegt, so wird die Terminwarnung
  362.           unterdr"uckt.
  363. *Oder*: `JJJJ@e|DVAR[+|-]NWWW'
  364.     `JJJJ'
  365.           (4 Ziffern), ist das Jahr einschlie"slich des Jahrhunderts
  366.           (Bereich 0000...9999).  Es sind f"uhrende Nullen anzugeben
  367.           falls das Jahr kleiner 1000 ist und weitere Komponenten des
  368.           Datumteils dem Jahr folgen.
  369.     `@e'
  370.           (2 Zeichen), ist ein Bezug auf das Datum des Ostersonntags.
  371.     `@DVAR'
  372.           (2 Zeichen), ist ein Bezug auf ein Datumvariable.
  373.     `[+|-]NWWW'
  374.           (3...7 alphanumerische Zeichen), ist der optionale Versatz in
  375.           Wochentagen, an welchem der Termin relativ zum Datum des
  376.           Ostersonntags oder zum Datum der Datumvariablen auftritt.
  377.           Falls das berechnete Datum nicht im Jahr auftritt, also
  378.           au"serhalb der Jahresgrenzen liegt, so wird die Terminwarnung
  379.           unterdr"uckt.
  380. *Oder*: Jede dieser Datumvariablenzuweisungen-/ operationen...
  381.      DVAR=MMTT
  382.      DVAR=MMWWWN
  383.      DVAR=*dN[WWW]
  384.      DVAR=*wN[WWW]
  385.      DVAR=DVAR
  386.      DVAR++
  387.      DVAR--
  388.      DVAR+=N
  389.      DVAR-=N
  390. *Bitte beachten:*
  391.    * Falls JJJJ nicht als festes Jahr, sondern als 0000 angegeben ist:
  392.      Es wird angenommen, da"s der Monat und Tag j"ahrliche Ereignisse
  393.      sind, und der *Textteil* wird f"ur jedes Jahr ausgegeben.
  394.    * Falls MM nicht als fester Monat, sondern als 00 oder gar nicht
  395.      angegeben ist:
  396.      Es wird angenommen, da"s der Tag ein monatliches Ereignis im
  397.      angegebenen Jahr ist, und der *Textteil* wird f"ur jeden Monat
  398.      ausgegeben.
  399.    * Falls TT nicht als fester Tag, sondern als 00 oder gar nicht
  400.      angegeben ist:
  401.      Es wird angenommen, da"s der Tag ein t"agliches Ereignis im
  402.      angegebenen Monat und Jahr ist, und der *Textteil* wird f"ur jeden
  403.      Tag ausgegeben.
  404.    * Falls ein Wochentagsname WWW im 2...3-stelligen Kurzformat
  405.      angegeben ist, z.B.: `Mon, Die...'
  406.      Es wird angenommen, da"s der gegebene Wochentagsname ein
  407.      w"ochentliches Ereignis im angegebenen Monat und Jahr ist, und der
  408.      *Textteil* wird f"ur jede Woche ausgegeben.
  409. File: gcal-de.info,  Node: Textteil einer Zeile,  Next: Zeile kommentieren,  Prev: Datumteil einer Zeile,  Up: Resourcendatei
  410. Textteil einer Zeile
  411. --------------------
  412. Der "Textteil" einer Zeile der Resourcendatei darf jeden beliebigen
  413. Text enthalten den Sie m"ogen.  Die L"ange eines Textteils ist
  414. unbegrenzt, aber der gesamte Text einer Terminwarnung (Datumteil,
  415. Hervorhebungssequenzen/Markierungszeichen und Textteil) wird stets auf
  416. MAXLEN Zeichen (derzeit 1024) gek"urzt.
  417. Ferner k"onnen *lange* Textzeilen aus der Resourcendatei umgebrochen
  418. werden.  Jedesmal, wenn ein `~' (Tilde) Zeichen im Textteil vorgefunden
  419. wird, so wird dieses Zeichen durch ein echtes `\n' (Newline) Zeichen
  420. ersetzt.
  421. Falls das `~' (Tilde) Zeichen als Zeichen selbst verwendet werden soll,
  422. so mu"s es durch ein f"uhrendes `\' (Backslash) Zeichen quotiert werden,
  423. z.B. `\~'.
  424. Wenn die Zeichen `\~' selbst als Zeichenfolge verwendet werden sollen,
  425. so mu"s das `\' (Backslash) Zeichen mit sich selbst quotiert werden,
  426. z.B. `\\~'.
  427. Eine Zeile der Resourcendatei wird auf der Folgezeile fortgesetzt, wenn
  428. eine `\-\n' (Backslash-Newline) Zeichensequenz vorgefunden wird, d.h.
  429. das Newline Zeichen der Zeile durch ein Backslash Zeichen unterdr"uckt
  430. wird, z.B.:
  431. Die Zeile:
  432.      000000Mo Jeden Montag
  433. und die Zeile:
  434.      000000Mo \
  435.      Jeden \
  436.      Montag
  437. sind identisch.
  438. File: gcal-de.info,  Node: Zeile kommentieren,  Next: Include Anweisungen,  Prev: Textteil einer Zeile,  Up: Resourcendatei
  439. Zeile kommentieren
  440. ------------------
  441. Eine Zeile der Resourcendatei, die mit einem `;' (Semikolon) Zeichen
  442. beginnt, ist ein Kommentar und wird von Gcal vollst"andig ignoriert!
  443. F"uhrende *whitespace* Zeichen d"urfen dem Kommentarzeichen vorangehen.
  444. File: gcal-de.info,  Node: Include Anweisungen,  Next: Spezielle Textmakros,  Prev: Zeile kommentieren,  Up: Resourcendatei
  445. Include Anweisungen
  446. -------------------
  447. Es d"urfen "#include" Anweisungen in einer Resourcendatei eingef"ugt
  448. werden (ein Mechanismus "ahnlich demjenigen, den der C Preprocessor
  449. benutzt), welche da"s Aufsuchen und Vorladen weiterer Resourcendateien
  450. bewirken, z.B.:
  451.   1. #include "foo/bar"
  452.   2. #include <bar>
  453. Die erste *#include* Anweisung regt Gcal an, die Datei `bar' aus dem
  454. Dateiverzeichnis `foo' mittels der Schritte 1...5 des bereits zuvor
  455. erkl"arten Datei-Suchmechanismus' einzuf"ugen (*note
  456. Datei-Suchmechanismus: Resourcendatei.).
  457. Die zweite *#include* Anweisung regt Gcal an, die Datei `bar' aus dem
  458. Benutzer- bzw. System-Bibliotheksverzeichnis mittels der Schritte 4...5
  459. des bereits zuvor erkl"arten Datei-Suchmechanismus' einzuf"ugen.
  460.      *Bitte beachten:*
  461.      Eingef"ugte Dateien d"urfen ihrerseits *keine* weiteren Dateien
  462.      einf"ugen, d.h. rekursive oder Sub-Einf"ugungen sind nicht erlaubt!
  463. File: gcal-de.info,  Node: Spezielle Textmakros,  Next: Datumvariablen,  Prev: Include Anweisungen,  Up: Resourcendatei
  464. Spezielle Textmakros
  465. --------------------
  466. Der Textteil einer Zeile der Resourcendatei darf neun spezielle
  467. Textmakros enthalten, welche gemischt und mehrfach verwendet auftreten
  468. d"urfen.  Diese Makrotexte beginnen alle mit dem `%' (Prozent) Zeichen,
  469. welches seinerseits durch ein f"uhrendes `\' (Backslash) Zeichen
  470. hinsichtlich seiner speziellen Bedeutung entwertet (quotiert) werden
  471. kann, falls das `%' (Prozent) Zeichen selbst im Textteil verwendet
  472. werden soll, z.B. `\%'.
  473.      *Bitte beachten:*
  474.      Das optionale Datum nach den `%b'..., `%y'..., `%s'... und `%e'...
  475.      Textmakros darf entweder im Datumformat `JJJJ[MM[TT|WWW[N]]]',
  476.      `JJJJ*d|wN[WWW]' oder `JJJJ@e|DVAR[[+|-]N[WWW]]' Datumformat
  477.      angegeben werden.
  478. * Menu:
  479. * %s Textmakro::  Wie ein Start eines Termins Textmakro benutzt wird.
  480. * %e Textmakro::  Wie ein Ende eines Termins Textmakro benutzt wird.
  481. * %b Textmakro::  Wie ein Geburtstags Textmakro benutzt wird.
  482. * %y Textmakro::  Wie ein Jahreszahl Textmakro benutzt wird.
  483. * %m Textmakro::  Wie ein Monatszahl Textmakro benutzt wird.
  484. * %w Textmakro::  Wie ein Wochenzahl Textmakro benutzt wird.
  485. * %d Textmakro::  Wie ein Tageszahl Textmakro benutzt wird.
  486. * %n Textmakro::  Wie ein Datumtext Textmakro benutzt wird.
  487. * %t Textmakro::  Wie ein Aktuelle Uhrzeit Textmakro benutzt wird.
  488. File: gcal-de.info,  Node: %s Textmakro,  Next: %e Textmakro,  Prev: Spezielle Textmakros,  Up: Spezielle Textmakros
  489. %s Textmakro
  490. ............
  491. `%s[JJJJ[MM[TT|WWW[N]]]]' bezeichnet das "Startdatum" eines Termins,
  492. d.h. das erste Datum, an dem dieser Termin auftreten darf.  Wenn das
  493. Datum, welches im `%s...' Textmakro kodiert ist, gr"o"ser dem laufenden
  494. bzw. abgefragten Datum ist, so wird der gesamte Warnungstext
  495. unterdr"uckt.  Wenn der Warnungstext angezeigt werden mu"s, so wird
  496. stets der gesamte Text dieses Makros bei der Ausgabe unterdr"uckt.
  497. Diesem Textmakro *mu"s* stets ein *whitespace* Zeichen folgen.
  498.    * Falls JJJJ... nicht angegeben ist (==*kein* Datum kodiert), so
  499.      wird der 01 Januar des laufenden Jahres als Datum angenommen.
  500.    * Falls JJJJ auf den Wert 0000 gesetzt ist, so wird das laufende Jahr
  501.      als Jahr angenommen.
  502.    * Falls MM nicht angegeben ist, so wird 01 (==Januar) als Monat
  503.      angenommen.
  504.    * Falls MM auf den Wert 00 gesetzt ist, so wird der laufende Monat
  505.      als Monat angenommen.
  506.    * Falls TT|WWW nicht angegeben ist, so wird 01 als Tag angenommen.
  507.    * Falls TT auf den Wert 00 gesetzt ist, so wird der laufende Tag als
  508.      Tag angenommen.
  509.    * Falls das N Feld angegeben ist (Bereich 1...5 oder 9), so mu"s
  510.      auch ein WWW Feld angegeben sein.
  511. File: gcal-de.info,  Node: %e Textmakro,  Next: %b Textmakro,  Prev: %s Textmakro,  Up: Spezielle Textmakros
  512. %e Textmakro
  513. ............
  514. `%e[JJJJ[MM[TT|WWW[N]]]]' bezeichnet das "Endedatum" eines Termins,
  515. d.h. das letzte Datum, an dem dieser Termin auftreten darf.  Wenn das
  516. Datum, welches im `%e...' Textmakro kodiert ist, kleiner dem laufenden
  517. bzw. abgefragten Datum ist, so wird der gesamte Warnungstext
  518. unterdr"uckt.  Wenn der Warnungstext angezeigt werden mu"s, so wird
  519. stets der gesamte Text dieses Makros bei der Ausgabe unterdr"uckt.
  520. Diesem Textmakro *mu"s* stets ein *whitespace* Zeichen folgen.
  521.    * Falls JJJJ... nicht angegeben ist (==*kein* Datum kodiert), so
  522.      wird der 31 Dezember des laufenden Jahres als Datum angenommen.
  523.    * Falls JJJJ auf den Wert 0000 gesetzt ist, so wird das laufende Jahr
  524.      als Jahr angenommen.
  525.    * Falls MM nicht angegeben ist, so wird 12 (==Dezember) als Monat
  526.      angenommen.
  527.    * Falls MM auf den Wert 00 gesetzt ist, so wird der laufende Monat
  528.      als Monat angenommen.
  529.    * Falls TT|WWW nicht angegeben ist, so wird der letzte Tag des
  530.      Monats MM als Tag angenommen.
  531.    * Falls TT auf den Wert 00 gesetzt ist, so wird der laufende Tag als
  532.      Tag angenommen.
  533.    * Falls das N Feld angegeben ist (Bereich 1...5 oder 9), so mu"s
  534.      auch ein WWW Feld angegeben sein.
  535. File: gcal-de.info,  Node: %b Textmakro,  Next: %y Textmakro,  Prev: %e Textmakro,  Up: Spezielle Textmakros
  536. %b Textmakro
  537. ............
  538. `%b[JJJJ[MM[TT|WWW[N]]]]' bezeichnet ein "Geburtsjahr" und wird in eine
  539. *Altersangabe* umgesetzt, z.B.:
  540.      Der Text `Mein %b1962 Geburtstag%s1952 %e2062' wird umgesetzt in
  541.      ==> `Mein 32 Geburtstag', falls das aktuelle Jahr 1994 ist.
  542. Die Altersangabe bei einem Geburtstag wird nur dann ausgegeben, wenn
  543. sich bei der Berechnung der Altersangabe ein Wert gr"o"ser Null ergibt.
  544. Zudem wird die Terminwarnung in diesem vorangehenen Beispiel nur
  545. w"ahrend der Jahre 1952 bis 2062 einschlie"slich ausgegeben.  Wenn der
  546. Warnungstext angezeigt werden mu"s, so wird stets der gesamte Text
  547. dieses Makros bei der Ausgabe unterdr"uckt.  Diesem Textmakro *mu"s*
  548. stets ein *whitespace* folgen.
  549.    * Falls JJJJ... nicht angegeben ist (==*kein* Datum kodiert), so
  550.      wird laufende Datum als Datum angenommen.
  551.    * Falls JJJJ auf den Wert 0000 gesetzt ist, so wird das laufende Jahr
  552.      als Jahr angenommen.
  553.    * Falls MM nicht angegeben oder auf den Wert 00 gesetzt ist, so wird
  554.      der laufende Monat als Monat angenommen.
  555.    * Falls TT|WWW nicht angegeben oder auf den Wert 00 gesetzt ist, so
  556.      wird der laufende Tag als Tag angenommen.
  557.    * Falls das N Feld angegeben ist (Bereich 1...5 oder 9), so mu"s
  558.      auch ein WWW Feld angegeben sein.
  559. File: gcal-de.info,  Node: %y Textmakro,  Next: %m Textmakro,  Prev: %b Textmakro,  Up: Spezielle Textmakros
  560. %y Textmakro
  561. ............
  562. `%y[JJJJ[MM[TT|WWW[N]]]]' bezeichnet jedwedes Jahr und wird in einen
  563. "Jahresdifferenzenwert" umgesetzt, z.B.:
  564.      Der Text `Silvester 1912 liegt %y1912 Jahre zur"uck' wird
  565.      umgesetzt in
  566.      ==> `Silvester 1912 liegt -82 Jahre zur"uck', falls das aktuelle
  567.      Jahr 1994 ist.
  568. Wenn der Warnungstext angezeigt werden mu"s, so wird stets der gesamte
  569. Text dieses Makros bei der Ausgabe unterdr"uckt.  Diesem Textmakro
  570. "mu"s" stets ein *whitespace* Zeichen folgen.
  571.    * Falls JJJJ... nicht angegeben ist (==*kein* Datum kodiert), so
  572.      wird laufende Datum als Datum angenommen.
  573.    * Falls JJJJ auf den Wert 0000 gesetzt ist, so wird das laufende Jahr
  574.      als Jahr angenommen.
  575.    * Falls MM nicht angegeben oder auf den Wert 00 gesetzt ist, so wird
  576.      der laufende Monat als Monat angenommen.
  577.    * Falls TT|WWW nicht angegeben oder auf den Wert 00 gesetzt ist, so
  578.      wird der laufende Tag als Tag angenommen.
  579.    * Falls das N Feld angegeben ist (Bereich 1...5 oder 9), so mu"s
  580.      auch ein WWW Feld angegeben sein.
  581. File: gcal-de.info,  Node: %m Textmakro,  Next: %w Textmakro,  Prev: %y Textmakro,  Up: Spezielle Textmakros
  582. %m Textmakro
  583. ............
  584. `%m' bezeichnet die laufende bzw. abgefragte "Monatsnummer" relativ zum
  585. aktuellen (==heutigen) Datum.
  586. File: gcal-de.info,  Node: %w Textmakro,  Next: %d Textmakro,  Prev: %m Textmakro,  Up: Spezielle Textmakros
  587. %w Textmakro
  588. ............
  589. `%w' bezeichnet die laufende bzw. abgefragte "Wochennummer" relativ zum
  590. aktuellen (==heutigen) Datum.
  591. File: gcal-de.info,  Node: %d Textmakro,  Next: %n Textmakro,  Prev: %w Textmakro,  Up: Spezielle Textmakros
  592. %d Textmakro
  593. ............
  594. `%d' bezeichnet die laufende bzw. abgefragte "Tagesnummer" relativ zum
  595. aktuellen (==heutigen) Datum, z.B.:
  596.      Die Resourcendateizeile `0 %d Tage vergangen' wird umgesetzt in
  597.      ==> `-10 Tage vergangen', falls Gcal mit der Option `-c10-' und
  598.      keinem Kommando aufgerufen wird.
  599. File: gcal-de.info,  Node: %n Textmakro,  Next: %t Textmakro,  Prev: %d Textmakro,  Up: Spezielle Textmakros
  600. %n Textmakro
  601. ............
  602. `%n[[+|-]N]' bezeichnet die laufende bzw.  abgefragte "Tagesnummer"
  603. relativ zum laufenden Datum plus/minus N Tagen und wird in einen, sich
  604. auf ein absolutes Datum beziehenden "Datumtext" umgesetzt, z.B.:
  605.      Die Resourcendateizeile `1962Sep21 10000 Tage alt: %n+10000' wird
  606.      umgesetzt in
  607.      ==> `10000 Tage alt: 06-Feb-1990', falls Gcal mit der einfachen
  608.      `-c' Option und dem `sep 1962' Kommando aufgerufen wird (*note `MM
  609.      JJJJ': Einfache Kommandos.).
  610. File: gcal-de.info,  Node: %t Textmakro,  Prev: %n Textmakro,  Up: Spezielle Textmakros
  611. %t Textmakro
  612. ............
  613. `%t[12|24]' bezeichnet die "aktuelle Systemuhrzeit", z.B.:
  614.      Der Text `Uhrzeit: %t --> Zahnarzttermin um 10:00 Uhr' wird
  615.      umgesetzt in
  616.      ==> `Uhrzeit: 07:32 --> Zahnarzttermin um 10:00 Uhr', falls die
  617.      aktuelle Systemuhrzeit 07:32 Uhr (hh:mm) ist.
  618. Ein Systemuhrzeitwert wird stets hervorgehoben ausgegeben.  Der
  619. Systemuhrzeitwert wird standardgem"a"s im *24-Stunden* Format
  620. ausgegeben.  Um im *12-Stunden* Format auszugeben, mu"s hinter `%t' die
  621. Zahl `12' geschrieben werden, z.B. `%t12'.
  622. File: gcal-de.info,  Node: Datumvariablen,  Prev: Spezielle Textmakros,  Up: Resourcendatei
  623. Datumvariablen
  624. --------------
  625. Gcal respektiert *globale* und/oder *lokale* Datumvariablen (*note
  626. `--date-variable=ARG': Terminwarnungs Optionen.).  Das bedeutet, da"s
  627. bis zu *25* benutzerdefinierte Datumvariablen gesetzt und w"ahrend der
  628. Programmausf"uhrung referenziert werden k"onnen.  Der Name einer
  629. Datumvariablen "dvar" besteht aus einem einzelnen Buchstaben
  630. (ausgenommen dem Buchstaben `e', welcher intern f"ur das Datum des
  631. Ostersonntags reserviert ist und welcher nichtzuweisbar/inoperabel ist)
  632. gefolgt von dem Zuweisungsoperator `=' und den Zahlenwerten f"ur Monat
  633. und Tag MMTT, welche diese Variable aufzunehmen hat (oder dem Namen
  634. einer anderen Datumvariablen), z.B.:
  635.      a=1127
  636.      b=054
  637.      c=a
  638. Nur an lokale Datumvariablen k"onnen dynamische Daten, die im `MMWWWN'
  639. oder `*d|wN[WWW]' Format angegeben werden, zugewiesen werden, z.B.:
  640.      a=03so2
  641.      b=JunMon9
  642.      x=*d10
  643.      y=*d10fre
  644.      z=*w3So
  645. Vorstehendes bedeutet, da"s die Datumvariable A das Datum des 2'ten
  646. Sonntags im M"arz speichert und B das Datum des letzten Montags im
  647. Monat Juni speichert.  Datumvariable X speichert das Datum des 10'ten
  648. absoluten Tages des Jahres (== 10'ter Januar).  Y speichert das Datum
  649. des 10'ten Freitags des Jahres, und Z wird das Datum des Sonntags, der
  650. in die 3'te Kalenderwoche f"allt, zugewiesen.
  651. *Achtung:*
  652. Diese Art der Zuweisung an Datumvariablen wird *nur* innerhalb einfacher
  653. Jahresgrenzen korrekt berechnet, also nicht in denjenigen
  654. Terminwarnungen, welche ausgegeben werden, nachdem das laufende Jahr
  655. gewechselt hat, z.B.  in `Fiskaljahren'.
  656. Datumvariablen die in einer Resourcendatei definiert werden sind stets
  657. lokal, und werden nur in dieser spezifischen Datei *und* derjenigen
  658. Datei respektiert, welche in diese eingef"ugt wird.  Das bedeutet
  659. hinsichtlich der eingef"ugten Datei, da"s alle lokalen Variablen der
  660. aufrufenden Datei sichtbar sind.  Die eingef"ugte Datei selbst darf
  661. eigene lokale Variablen definieren, welche dann die bereits an anderer
  662. Stelle definierten lokalen Variablen "uberdecken und welche nicht bei
  663. R"uckkehr zur aufrufenden Datei exportiert werden.  Alle anderen
  664. Definitionen von Datumvariablen (in der Kommandozeile,
  665. Umgebungsvariablen `GCAL' oder Antwortdatei) sind stets global.  Falls
  666. eine Zeile einer Resourcendatei eine Referenz auf eine Datumvariable
  667. enth"alt, die nicht lokal in dieser Datei definiert ist, so wird Gcal
  668. versuchen, die Werte der entsprechenden globalen Variablen zu benutzen.
  669. Sollte dieses nicht gelingen, da keine globale Definition dieser
  670. Datumvariablen vorliegt, so wird Gcal diese Zeile nicht verarbeiten.
  671. Wenn zudem die einfache `--debug' bzw. `--debug=internal' Option
  672. angegeben wurde, so wird ein Warnungstext f"ur jede undefinierte
  673. Datumvariable ausgegeben (*note `--debug=internal': Globale Optionen.).
  674. Falls die `--debug=abort' Option angegeben wurde, so wird Gcal das
  675. Programm dann abbrechen, sobald die erste Referenz einer undefinierten
  676. Datumvariablen auftritt.  F"ur weitere Informationen, siehe auch *Note
  677. `--debug=abort': Globale Optionen.
  678. Nur fortgeschrittene Benutzer sollten die `--hidden' Option benutzen,
  679. welche bewirkt, da"s die aktuelle Inkarnation einer lokalen
  680. Datumvariablen - welche zuvor in einer Resourcendatei definiert wurde
  681. und nicht in einer eingef"ugten Datei - an weitere Resourcendateien
  682. exportiert wird anstelle der Benutzung deren globalen Wertes, falls
  683. diese Datumvariable nicht lokal in dieser weiteren Resourcendatei
  684. definiert ist.
  685.   *Note Include Anweisungen::.
  686. Aber seien Sie vorsichtig, die Benutzung dieser Option k"onnte
  687. unerwartete Ergebnisse erzeugen, da die Reihenfolge der Abarbeitung der
  688. Resourcendateien eine wichtige Gr"o"se hinsichtlich der Handhabung der
  689. `--hidden' Option ist, so da"s es nicht empfohlen werden kann, diese
  690. Option zu benutzen.  Sie, der Benutzer, m"ussen sehr genau wissen was
  691. Sie mit dieser Option bewirken wollen; *Sie seien nun ausdr"ucklich
  692. gewarnt!*
  693. Einige grundlegende Operationen k"onnen auf Datumvariablen ausgef"uhrt
  694. werden:
  695. `DVAR++'
  696.      Einfache Inkrementierung um einen Tag.
  697. `DVAR--'
  698.      Einfache Dekrementierung um einen Tag.
  699. `DVAR+=N'
  700.      Addition eines konstanten numerischen Tagesfaktors N.
  701. `DVAR-=N'
  702.      Subtraktion eines konstanten numerischen Tagesfaktors N.
  703. Der G"ultigkeitsbereich der Operationen, welche auf einer lokalen
  704. Datumvariablen durchgef"uhrt werden, erstreckt sich auf die
  705. Resourcendatei oder die eingef"ugte Datei, in welcher die lokale
  706. Datumvariable definiert wurde.
  707. Falls Operationen auf eine globale Datumvariable in einer
  708. Resourcendatei oder in derjenigen Datei, die in diese eingef"ugt wird,
  709. durchgef"uhrt werden, so sind diese Operationen nur in dieser
  710. entsprechenden g"ultig (diese werden nur lokal ausgef"uhrt), nicht in
  711. weiteren Resourcendateien, welche verarbeitet werden.  Das bedeutet,
  712. da"s die Initialwerte der globalen Datumvariablen stets restauriert
  713. werden, falls die zu verarbeitende Resourcendatei wechselt.
  714. Bitte beachten Sie, da"s jede Datumvariablenzuweisung-/ operation in
  715. einer einzelnen Zeile der Resourcendatei angegeben werden mu"s.
  716. File: gcal-de.info,  Node: Resourcendateibeispiele,  Prev: Resourcendatei,  Up: Terminwarnungen
  717. Resourcendateibeispiele
  718. =======================
  719. Hier sind einige Beispiele wie eine Resourcendatei aussehen k"onnte:
  720.      ; Das ist ein Beispiel einer Resourcendatei
  721.      ;
  722.      19940715 Uhrzeit: %t --> Zahnarzttermin um 10:00 Uhr
  723.      00000921 Mein %b1962 Geburtstag%s1962 %e2062
  724.      0000093 Die~Gregorianische Reformation\~war vor %y1582 Jahren
  725.      0000Sep03 Die~Gregorianische Reformation\~war vor %y1582 Jahren
  726.      0 Jeder Tag in jedem Monat in jedem Jahr
  727.      0000 Jeder Tag in jedem Monat in jedem Jahr
  728.      00000000 Jeder Tag in jedem Monat in jedem Jahr
  729.      199400fre        Immer Freitags 1994
  730.      000007mo3 Jeder dritte Montag im Juli~jedes Jahres kleiner 1980%e1979
  731.      0000@e-10 Ostersonntag-10 Tage in jedem Jahr
  732.      0@e-10 Ostersonntag-10 Tage in jedem Jahr
  733.      00000000@e+10 Ostersonntag+10 Tage in jedem Jahr
  734.      a=1127
  735.      0@a+20 20 Tage nach dem Datum der Datumvariablen `a'
  736.      a=*W10FR
  737.      0@a-1 Der Donnerstag der 10'ten ISO-Woche in jedem Jahr
  738.      0@a   Der Freitag der 10'ten ISO-Woche in jedem Jahr
  739.      0@a1  Der Samstag der 10'ten ISO-Woche in jedem Jahr
  740.      1995*d10    Der 10'te absolute Tag in 1995
  741.      1995*d99die Der letzte Dienstag in 1995
  742.      0*w99so Der Sonntag der letzten ISO-Woche in jedem Jahr
  743. File: gcal-de.info,  Node: Heutiger Kalender,  Next: Metasymbole,  Prev: Terminwarnungen,  Up: Top
  744. Entstehungsgeschichte des Gregorianischen Kalenders
  745. ***************************************************
  746. Der heutzutage benutzte Kalender wurde zuerst von den R"omern in
  747. zahlreichen ungenauen Variationen formuliert.  In der Zeit des Julius
  748. Caesar fiel der Monat Januar in den Herbst.  So wurde Sosigenes
  749. befohlen eine Kalenderreform durchzuf"uhren.  Dieser addierte 90 Tage
  750. zu dem Jahr 46 vor Christus um den jahreszeitlichen Versatz zu
  751. korrigieren.  Zudem modifizierte er die Monatsl"angen in der Form wie
  752. wir sie heute noch benutzen.  Weiterhin wurde das Schaltjahr von ihm
  753. eingef"uhrt, indem alle vier Jahre ein weiterer Tag im Monat Februar
  754. hinzuaddiert wurde.  Die Benutzung eines Schaltjahres war eine echte
  755. Verbesserung der Kalenderrechnung, aber noch nicht im vollen Umfang
  756. exakt.  Die L"ange eines Sonnenjahres betr"agt 365 Tage, 5 Stunden, 48
  757. Minuten und 46 Sekunden.  Ein 366-Tage Jahr, welches alle vier Jahre
  758. stattfindet, setzt das Durchschnittsjahr auf 365 Tage und 6 Stunden.
  759. Das bedeutet, da"s sich alle vier Jahre ein Fehler von 44 Minuten und
  760. 56 Sekunden in die Kalenderrechnung einschleicht.  Dieser Kalender ist
  761. als der "Julianische" Kalender in die Geschichtsschreibung eingegangen.
  762. So kam es, da"s der Fr"uhlingsanfang im 16'ten Jahrhundert auf den
  763. 11'ten M"arz fiel.  Papst Gregor XIII ordnete eine weitere
  764. Kalenderreform an um diesen Fehler zu kompensieren.  So wurde der
  765. Fr"uhlingsanfang auf den 21'ten M"arz festgelegt und Donnerstag, der
  766. 4'te Oktober wurde gefolgt von Freitag, dem 15'ten Oktober, indem
  767. einfach 10 Tage im Kalender "ubersprungen wurden.  Weiterhin wurde alle
  768. 400 Jahre ein Schaltjahrhundert eingef"uhrt.  Diese Regelung
  769. verminderte den Fehler in der Kalenderrechnung um weitere 72 Stunden (3
  770. Tage) alle 400 Jahre.  Der aktuelle "Uberschu"s betr"agt akkumuliert 74
  771. Stunden, 53 Minuten und 20 Sekunden.  Der Fehler von 2 Stunden, 53
  772. Minuten und 20 Sekunden pro Zeitraum von 400 Jahren bel"auft sich auf
  773. einen Tag in 3323 Jahren.  Na gut, niemand ist perfekt.
  774. Katholisch regierte L"ander "ubernahmen diesen Kalender sofort oder
  775. innerhalb weniger Jahre.  Die meisten protestantisch regierten L"ander
  776. auf dem europ"aischen Kontinent "ubernahmen den neuen Gregorianischen
  777. Kalender um 1700.  England und die amerikanischen Kolonien wechselten
  778. zu dem Kalender im Jahre 1752 durch Parlamentsbeschlu"s.  Orthodox
  779. christianisierte L"ander "ubernahmen den Gregorianischen Kalender
  780. sp"ater. Russland war das letzte europ"aische Land was das tat, und
  781. zwar nach der Kommunistischen Revolution, welche am 25'ten Oktober 1917
  782. (Gregorianisch) stattfand.  Daraus resultierte, da"s die UDSSR den Tag
  783. der Oktoberrevolution nach dem alten Julianischen Kalender am 7'ten
  784. November feierte.
  785. In der deutschen Programmversion wird angenommen, da"s die
  786. Gregorianische Reformation am 5'ten Oktober 1582 stattgefunden hat.
  787. File: gcal-de.info,  Node: Metasymbole,  Next: Kodierschema,  Prev: Heutiger Kalender,  Up: Top
  788. Metasymbole
  789. ***********
  790. Folgende *metasprachliche* Konventionen werden bei der Darstellung von
  791. Optionen, Argumenten und Kommandos innerhalb dieses Dokumentes
  792. verwendet:
  793.      Nichtoptionales Argument, N mu"s eine zul"assige Zahl sein.
  794. `e|DVAR'
  795.      Nichtoptionales Argument, welches ein einzelnes alphabetisches
  796.      Zeichen sein mu"s.
  797. `[TEXT]'
  798.      Optionales Argument, TEXT ist eine zul"assige alphanumerische
  799.      Zeichenkettenkonstante.
  800. `[AB]'
  801.      Optionale Argumente, deren Anzahl und Anordung beliebig ist, z.B.:
  802.           NICHTS, A, B, AB, BA ...
  803. `{AB}'
  804.      Nichtoptionale Argumente, deren Anordnung beliebig ist und von
  805.      denen mindestens eins bis hin zu einer beliebigen Anzahl angegeben
  806.      werden kann, z.B.:
  807.           A, B, AB, BA ...
  808. `[A|B]'
  809.      Optionale Argumente, entweder A oder B, aber nicht beide.
  810. `A|B'
  811.      Nichtoptionale Argumente, entweder A oder B, aber nicht beide.
  812. `[A[B]]'
  813.      Optionale Argumentliste, entweder A oder AB, aber nicht B.
  814. `[A|B[C]]'
  815.      Optionale Argumentliste, entweder A oder B oder AB oder AC, aber
  816.      nicht C.
  817. `[A|BC]'
  818.      Optionale Argumentliste, entweder AC oder BC, aber nicht A oder B
  819.      oder C.
  820. `[A]|[B]'
  821.      Optionale Argumentlisten, entweder Liste A oder Liste B, aber
  822.      nicht beide.
  823. `[...]'
  824.      Zus"atzliche Argumente/Dateien d"urfen angegeben werden und sind
  825.      optional.
  826. File: gcal-de.info,  Node: Kodierschema,  Next: Umgebungsvariablen,  Prev: Metasymbole,  Up: Top
  827. Kodierschema
  828. ************
  829. Es folgt nun die tabellarische Aufstellung des Kodierschemas, welches
  830. f"ur den *Datumteil* (JJJJ...) einer Zeile der Resourcendatei verwendet
  831. werden kann, und der Modifizierer, welche die Kurzoption `-c|C[]'
  832. annehmen darf, bzw. die Argumente, welche die Langoption
  833. `--period-of-fixed-dates=ARG' annehmen darf.  Aus diesen Tabellen kann
  834. ersehen werden, welche *Terminwarnungs* Argumente mit welchem
  835. *Datumteil* einer Zeile der Resourcendatei korrespondieren, d.h. bei
  836. Anwahl eines *Terminwarnungs* Arguments ber"ucksichtigt werden; da Gcal
  837. eben nicht alle vorhandenen Eintr"age in einer Resourcendatei
  838. ber"ucksichtigt, sondern nur solche, die in einem bestimmten
  839. Verh"altnis zum *Terminwarnungs* Argument stehen!
  840. Im *Datumsteil* `JJJJ...':
  841.      bedeutet jede Jahreszahl (0001...9999).
  842.      bedeutet jede Monatszahl (01...12 oder 99) bzw. jeden texlichen
  843.      Monatsnamen im 3-stelligen Kurzformat (Jan, Feb...).
  844.      bedeutet jede Tageszahl (01...28, 29, 30, 31 oder 99).
  845.      bedeutet jeden textlichen Wochentagsnamen im 2...3-stelligen
  846.      Kurzformat (Mon...Son).
  847.      bedeutet jedes alphabetische Zeichen.
  848.      bedeutet jede Zahl (eine oder mehrere Ziffern).
  849. * Menu:
  850. * Kodierschema Tabelle 1::
  851. * Kodierschema Tabelle 2::
  852. File: gcal-de.info,  Node: Kodierschema Tabelle 1,  Next: Kodierschema Tabelle 2,  Prev: Kodierschema,  Up: Kodierschema
  853. Kodierschema Tabelle 1
  854. ======================
  855. In dieser Tabelle werden alle m"oglichen Kodierungen eines Datums im
  856. *Datumteil* einer Resourcendatei mit allen dazu m"oglichen Kodierungen
  857. der Modifizierer der Kurzoption `-c|C[]' gegen"ubergestellt.
  858.      *Bitte beachten:*
  859.      Die `-c', `-ct', `-cNd', `-c*d|wN[WWW]', `-c@e|DVAR[[+|-]N[WWW]]',
  860.      `-cMMTT' und `-cMMWWWN' Optionen ber"ucksichtigen *alle*
  861.      Kodiervariationen des *Datumteils*!
  862. `*Datumteil einer Resourcendatei*'
  863.      `*Kurzoption -c|C[]*'
  864. `00000000'
  865.      `-cN+|-'
  866. `000000TT'
  867.      `-cNw|+|-', `-cw[+|-]', `-cm[+|-]'
  868. `0000MM00'
  869.      `-cN+|-'
  870. `0000MMTT'
  871.      `-cNw|+|-', `-cw[+|-]', `-cm[+|-]', `-cy[+|-]', `-clNd|w|+|-',
  872.      `-cl*d|wN[WWW]',
  873.      `-cl@e|DVAR[[+|-]N[WWW]]', `-clMMTT', `-clMMWWWN'
  874. `JJJJ0000'
  875.      `-cN+|-'
  876. `JJJJ00TT'
  877.      `-cNw|+|-', `-cw[+|-]', `-cm[+|-]'
  878. `JJJJMM00'
  879.      `-cN+|-'
  880. `JJJJMMTT'
  881.      `-cNw|+|-', `-cw[+|-]', `-cm[+|-]', `-cy[+|-]', `-clNd|w|+|-',
  882.      `-cl*d|wN[WWW]',
  883.      `-cl@e|DVAR[[+|-]N[WWW]]', `-clMMTT', `-clMMWWWN'
  884. `000000WWW'
  885.      `-cNw|+|-', `-cw[+|-]'
  886. `0000MMWWW'
  887.      `-cNw|+|-', `-cw[+|-]'
  888. `JJJJ00WWW'
  889.      `-cNw|+|-', `-cw[+|-]'
  890. `JJJJMMWWW'
  891.      `-cNw|+|-', `-cw[+|-]'
  892. `000000WWWN'
  893.      `-cNw|+|-', `-cw[+|-]', `-cm[+|-]'
  894. `0000MMWWWN'
  895.      `-cNw|+|-', `-cw[+|-]', `-cm[+|-]', `-cy[+|-]', `-clNd|w|+|-',
  896.      `-cl*d|wN[WWW]',
  897.      `-cl@e|DVAR[[+|-]N[WWW]]', `-clMMTT', `-clMMWWWN'
  898. `JJJJ00WWWN'
  899.      `-cNw|+|-', `-cw[+|-]', `-cm[+|-]'
  900. `JJJJMMWWWN'
  901.      `-cNw|+|-', `-cw[+|-]', `-cm[+|-]', `-cy[+|-]', `-clNd|w|+|-',
  902.      `-cl*d|wN[WWW]',
  903.      `-cl@e|DVAR[[+|-]N[WWW]]', `-clMMTT', `-clMMWWWN'
  904. `0000*dN[WWW]'
  905.      `-cNw|+|-', `-cw[+|-]', `-cm[+|-]', `-cy[+|-]', `-clNd|w|+|-',
  906.      `-cl*d|wN[WWW]',
  907.      `-cl@e|DVAR[[+|-]N[WWW]]', `-clMMTT', `-clMMWWWN'
  908. `JJJJ*dN[WWW]'
  909.      `-cNw|+|-', `-cw[+|-]', `-cm[+|-]', `-cy[+|-]', `-clNd|w|+|-',
  910.      `-cl*d|wN[WWW]',
  911.      `-cl@e|DVAR[[+|-]N[WWW]]', `-clMMTT', `-clMMWWWN'
  912. `0000*wN[WWW]'
  913.      `-cNw|+|-', `-cw[+|-]', `-cm[+|-]', `-cy[+|-]', `-clNd|w|+|-',
  914.      `-cl*d|wN[WWW]',
  915.      `-cl@e|DVAR[[+|-]N[WWW]]', `-clMMTT', `-clMMWWWN'
  916. `JJJJ*wN[WWW]'
  917.      `-cNw|+|-', `-cw[+|-]', `-cm[+|-]', `-cy[+|-]', `-clNd|w|+|-',
  918.      `-cl*d|wN[WWW]',
  919.      `-cl@e|DVAR[[+|-]N[WWW]]', `-clMMTT', `-clMMWWWN'
  920. `0000@?[+|-]N[WWW]'
  921.      `-cNw|+|-', `-cw[+|-]', `-cm[+|-]', `-cy[+|-]', `-clNd|w|+|-',
  922.      `-cl*d|wN[WWW]',
  923.      `-cl@e|DVAR[[+|-]N[WWW]]', `-clMMTT', `-clMMWWWN'
  924. `JJJJ@?[+|-]N[WWW]'
  925.      `-cNw|+|-', `-cw[+|-]', `-cm[+|-]', `-cy[+|-]', `-clNd|w|+|-',
  926.      `-cl*d|wN[WWW]',
  927.      `-cl@e|DVAR[[+|-]N[WWW]]', `-clMMTT', `-clMMWWWN'
  928. File: gcal-de.info,  Node: Kodierschema Tabelle 2,  Prev: Kodierschema Tabelle 1,  Up: Kodierschema
  929. Kodierschema Tabelle 2
  930. ======================
  931. In dieser Tabelle werden alle m"oglichen Kodierungen der Modifizierer
  932. der Kurzoption `-c|C[]' mit allen dazu m"oglichen Kodierungen eines
  933. Datums im *Datumteil* einer Resourcendatei gegen"ubergestellt.
  934. `*Kurzoption -c|C[]*'
  935.      `*Datumteil einer Resourcendatei*'
  936. `-ct'
  937. `-cNd|+|-'
  938. `-cMMTT'
  939. `-cMMWWWN'
  940. `-c*d|wN[WWW]'
  941. `-c@e|DVAR[[+|-]N[WWW]]'
  942.      `00000000', `0000MM00', `JJJJ0000', `JJJJMM00', `000000TT',
  943.      `0000MMTT', `JJJJ00TT', `JJJJMMTT', `000000WWW', `0000MMWWW',
  944.      `JJJJ00WWW', `JJJJMMWWW', `000000WWWN', `0000MMWWWN', `JJJJ00WWWN',
  945.      `JJJJMMWWWN', `0000*dN', `0000*dNWWW', `JJJJ*dN', `JJJJ*dNWWW',
  946.      `0000*wN', `0000*wNWWW', `JJJJ*wN', `JJJJ*wNWWW', `0000@?[+|-]N',
  947.      `0000@?[+|-]NWWW', `JJJJ@?[+|-]N', `JJJJ@?[+|-]NWWW'
  948. `-cw[+|-]'
  949. `-cNw'
  950.      `000000TT', `0000MMTT', `JJJJ00TT', `JJJJMMTT', `000000WWW',
  951.      `0000MMWWW', `JJJJ00WWW', `JJJJMMWWW', `000000WWWN', `0000MMWWWN',
  952.      `JJJJ00WWWN', `JJJJMMWWWN', `0000*dN', `0000*dNWWW', `JJJJ*dN',
  953.      `JJJJ*dNWWW', `0000*wN', `0000*wNWWW', `JJJJ*wN', `JJJJ*wNWWW',
  954.      `0000@?[+|-]N', `0000@?[+|-]NWWW', `JJJJ@?[+|-]N',
  955.      `JJJJ@?[+|-]NWWW'
  956. `-cm[+|-]'
  957.      `000000TT', `0000MMTT', `JJJJ00TT', `JJJJMMTT', `000000WWWN',
  958.      `0000MMWWWN', `JJJJ00WWWN', `JJJJMMWWWN', `0000*dN', `0000*dNWWW',
  959.      `JJJJ*dN', `JJJJ*dNWWW', `0000*wN', `0000*wNWWW', `JJJJ*wN',
  960.      `JJJJ*wNWWW', `0000@?[+|-]N', `0000@?[+|-]NWWW', `JJJJ@?[+|-]N',
  961.      `JJJJ@?[+|-]NWWW'
  962. `-cy[+|-]'
  963. `-clNd|w|+|-'
  964. `-clMMTT'
  965. `-clMMWWWN'
  966. `-cl*d|wN[WWW]'
  967. `-cl@e|DVAR[[+|-]N[WWW]]'
  968.      `0000MMTT', `JJJJMMTT', `0000MMWWWN', `JJJJMMWWWN', `0000*dN',
  969.      `0000*dNWWW', `JJJJ*dN', `JJJJ*dNWWW', `0000*wN', `0000*wNWWW',
  970.      `JJJJ*wN', `JJJJ*wNWWW', `0000@?[+|-]N', `0000@?[+|-]NWWW',
  971.      `JJJJ@?[+|-]N', `JJJJ@?[+|-]NWWW'
  972. File: gcal-de.info,  Node: Umgebungsvariablen,  Next: Fehlerkodes,  Prev: Kodierschema,  Up: Top
  973. Umgebungsvariablen
  974. ******************
  975. Hier ist eine Liste aller Umgebungsvariablen, die von Gcal benutzt
  976. werden:
  977. `COLUMNS'
  978.      Setzt die Anzahl der Spalten des Bildschirms.  Hat Vorrang vor der
  979.      Anzahl der Spalten, welche die `TERM' Umgebungsvariable oder das
  980.      System selbst definiert.
  981. `HOME'
  982.      Name des Heimatverzeichnisses des Benutzers (wird benutzt um die
  983.      `.gcalrc' Datei zu finden).  Hat Vorrang vor `GCALPATH',
  984.      `GCAL_USR_LIBDIR' und `GCAL_SYS_LIBDIR'.
  985. `GCAL'
  986.      Argumente welche an Gcal automatisch "ubergeben werden.
  987. `GCALANSI'
  988.      Wenn definiert oder gesetzt, so werden ANSI
  989.      Escape-Hervorhebungssequenzen als Grundeinstellung benutzt bzw.
  990.      substituiert, falls keine anderen Hervorhebungssequenzen mittels
  991.      Kommandozeilenoption definiert werden oder in der Termcap
  992.      Bibliotheksdatei aufgefunden werden.
  993. `GCALPATH'
  994.      Durch (`:') Doppelpunkt separierte Liste von Dateiverzeichnissen,
  995.      welche durchsucht werden, um die `.gcalrc' Datei zu finden.  Hat
  996.      Vorrang vor `GCAL_USR_LIBDIR' und `GCAL_SYS_LIBDIR'.
  997. `GCAL_USR_LIBDIR'
  998.      Name eines Dateiverzeichnisses relativ zum `HOME'
  999.      Dateiverzeichnis, in welchem der Benutzer seine pers"onlichen bzw.
  1000.      *privaten* Resourcendateien (Termindateien) speichert.  Hat
  1001.      Vorrang vor `GCAL_SYS_LIBDIR'.
  1002. `GCAL_SYS_LIBDIR'
  1003.      Name eines Dateiverzeichnisses absolut zum *Wurzel*/*$(prefix)*
  1004.      Dateiverzeichnis, in welchem der Systemadministrator allgemeine
  1005.      bzw.  *"offentliche* Resourcendateien (Termindateien) speichert.
  1006. `LINES'
  1007.      Setzt die Anzahl der Zeilen des Bildschirms.  Hat Vorrang vor der
  1008.      Anzahl der Zeilen, welche die `TERM' Umgebungsvariable oder das
  1009.      System selbst definiert.
  1010. `PAGER'
  1011.      Der Names des externen Paginiererprogramms, das verwendet wird,
  1012.      wenn Paginierung (`-p' bzw. `--pager' Option) gew"unscht wird.
  1013. `PATH'
  1014.      Durch (`:') Doppelpunkt separierte Liste von Dateiverzeichnissen,
  1015.      welche durchsucht werden, um das "externe" Paginiererprogramm zu
  1016.      finden.  *Note `--pager': Globale Optionen, f"ur weitere Details.
  1017. `TERM'
  1018.      Der Terminaltyp, auf dem Gcal zum Ablauf kommt.
  1019.